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SYSTEMS TECHNOLOGY 
A DIVISION OF FAIRCHILD CAMERA AND INSTRUMENT CORPORATION 


PREFACE 


This manual describes callable system subroutine that are available to the user. 
These routines are automatically loaded when called by the user's program. A fa- 
miliarity with disk files and disk operating system (DOPSY) procedures is assumed. 
For additional or reference information refer to the following publications: 


Publications Manual Part Number 
Sentry VII User Manual 27000013 
FST-2 Computer Manual 97000002 
Sentry VII Communication Link User's Manual 07000003 
FST-1 Assembler Reference Manual 67094951 


Register Formats Reference Manual 67095504 
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SECTION 1 
IOCS PROCEDURES 


1.1 INTRODUCTION 


All of the I/O routines are very similar with regard to calling sequence and usage. 
The similarities will be discussed in this section; subsequent sections deal with the 
particulars for each I/O routine. 


An I/O procedure acknowledges two types of calls. The first of these is used to 
initiate an operation on a device. Its general form is: 


CALL ioname 

DATA integer 

DATA deb address/integer 
(DATA name) 


The name of the I/O procedure occurs in the operand of the CALL statement. The 
DATA statement immediately following the CALL specifies the operation to be 
performed. These values and the operations assigned to them are described in 
Table 1.1. 


If the operation is one involving a data transfer, the second location after the 
CALL will contain the address of the data control block, DCB, where the following 
information is stored. The first word of the DCB is the number of words to be 
transferred, the second is the core memory address of the first location to be 
read/written; the third word of the DCB is required only for disc transfers and is 
the dise address (in segments) of where the data is to be read or written. 


Example 


DATA 48, *+2, 80 
BSS 48 


This DCB ean be used for a 48 word transfer between core memory and track one, 
sector zero on the dise. The DCB and its corresponding buffer area should not be 
altered until the I/O operation has been successfully completed; this is true of all 
I/O operations. 


For some operations not involving a data transfer, the entry at CALL+2 will con- 


tain a count. The SPACE operation of LPIO, for example, uses this count to deter- 
mine how far to space. 


i=f 


4 | TABLE 1-1 SUBROUTINE CALLING SEQUENCE OPERATION CODES 


“Subroutines 


Octal 
Code | TTRIO TTPIO CRIO =| DISCIO LPIO MTIO 


I pusy | BUSY Busy | BUSY BUSY BUSY 
| READ READ | READ READ BINARY 
TIK BINARY | BINARY 
| READ READ 
TTR ALPHA 
KILL | PRINT BINARY WRITE ae WRITE BINARY 
cr-1f* BINARY 
| FEED 
PRINT WITH WRITE TAPE MARK 
LINE FEED 


RECORD SKIP FORWARD 


SPACE N RECORD SKIP BACK 
LINES 


TOP OF FORM REWIND 


FILE SKIP FORWARD 


| Type 
of Code 


le & 
ae El 


tt 


FILE SKIP BACK 


PRINT BINARY 
no cr-IlIf 

1 PRINT BCD 

no cr-lIf 


* cr-If is carriage return - line feed 


= 
s 
oud e 
HE 
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The entry at CALL+t3 is not used by all I/O procedures, but when used it must 
contain the address of a user error routine. This error routine will be entered when 
either a recoverable error persists after ten attempts to correct it or an error in 
the DCB has been detected. This error routine is treated as an extension of the I/O 
interrupt routine and must return by executing a BRU* to its entry point. The A 
register will have the following format when the error routine is entered: 


Bit Description 
19 On if DCB error. 


20 On if data overflow. 

21 On if parity or validity error. 
22 On if end-of-file (EOF). 

6-0 Device address. 


More than one of the bits 22-19 may be on at a time. 
Some general comments on these error conditions: 


DCB errors either result from the memory address exceeding the core avail- 
able or from an excessive word count. 


Data overflow results when a device needs a memory cycle to empty/fill a 
buffer and, because of other memory demands, cannot get one. 


Parity/validity error indicates a data transmission error, illegal ecard codes, 
etc. 


When control returns to the I/O interrupt routine, the operation will be accepted as 
eorrect if the A register is non-zero; otherwise, it will be tried again. 


As they are currently implemented, the I/O routines, except those for the teletype, 
use locations 75B-77B as a pre-operative error routine. An illegal operation value 
or device not ready will cause a halt at 76B to be executed. This can be readily 
identified by the fact that the program counter is 100B and the A register contains 
the device number in bits 6-0. | 


The I/O procedures operate with the interrupt system and automatically overlap 
I/O with program execution. In order for the user to take advantage of this, a 
special type of call is provided Its general format is: 


CALL ioname 

DATA 0 

-—~ BUSY RETURN 

-—— NOT BUSY RETURN 


This "operation" tests to see if the I/O routine has completed processing the pre- 


vious non-test operation. If the I/O routine is busy, control will return to CALL+2; 
if it is idle, (data transfer complete), control will return to CALL+3. 
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No provision is made in the I/O procedure for handling re-entrancy. The user 
should, therefore, be very careful about calling I/O routines from interrupt pro- 
cessors. When an I/O routine is called, it will save and restore any index registers 
that it requires, but will not save or restore the A and E registers. The interrupt 
routines, obviously, are not quite so reckless. 


If an I/O routine is CALLed by a user program, care must be taken to insure that in 
ease of any software error, control is returned to the Automatie Restart Routine 
(ARR, location 125B) so that all interrupt entrance locations will be relinked with 
the proper system routine. 


In the following paragraphs the details of each I/O routine are presented. Since the 
"test" operation is the same for all such routines, further discussion is not required 
an is, therefore, omitted. 


1.2 TTPIO 
Purpose:. ‘To output a record to the teletype. 
Calling Sequence: 


CALL TTPIO 

DATA operation 

DATA deb 

= NORMAL RETURN 


operation - 3 BINARY print, with CR/LF. 
4 BCD print, with CR/LF. 
13, BINARY print, without CR/LF. 
14, BCD print, without CR/LF. 


Description: 


TTPIO will output to the teletype the contents of the buffer described by the DCB. 
The buffer is assumed to contain four TASCII characters per word; see Appendices 
A and B. TTPIO will output a carriage return and line feed after the last character 
is printed only if bit 3 of the operation is not set. Because of the 72-character 
limit to a teletype line, the word count must be less than 19 or the last characters 
will be truncated. In the BINARY mode, every character in the buffer will be 
printed. In the BCD mode, trailing blanks will not be printed. 


Because the teleprinter is also shared with TTRIO, TTPIO sets a flag in the 
COMREC so that no keyboard input can be initiated while an output operation is 
being performed. | 

1.3 TTRIO 


Purpose: To input a record from the teletype keyboard or paper tape reader. 
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Calling Sequence: 


OR 
CALL TTRIO CALL TTRIO 
DATA operation DATA operation 


DATA deb mn 
—_ NORMAL RETURN 


operation - 1 READ keyboard operation - 9 BUSY test 
2 READ paper tape 3 KILL pending input 
Description: 


TTRIO will input into the specified buffer until the buffer is full or until a carriage 
return is encountered; in the latter case, the buffer will be padded with spaces. 
The TASCII characters are placed in the buffer four per word, see Appendices A 
and B. When TTRIO is ready for keyboard input, it will output the character 
obtained from the high-order six bits of the operation entry. If unspecified, it will 
be a space. This character can be used to uniquely identify the source of the input 
request, i.e., the monitor's *, etc. 


All characters read from the keyboard will be echoed, i.e., sent to the teleprinter; 
like paper tape input, however, only the printing characters, the TASCII set, are 
placed in the buffer. Two of the control characters are used by TTRIO to provide 
limited editing. The characters produced by CTRL B and CTRL L are used to 
indicate BACKSPACE and LINE DELETE, respectively. 


CTRL B will cause the buffer character pointer to be backed up one character 
position. This is indicated by echoing a ' 'if the input is from the keyboard. 


Example: 
he RENS AME'TESTI 2' AS 'TEST3" 
// RENAME 'TEST2' AS 'TEST3'! 


CTRL L will cause the buffer character pointer to be set to zero. This is indicated 
by echoing carriage return, line feed, and the input request character, if the input 
is from the keyboard. The same net result, emptying the input buffer, could be 
obtained by an appropriate number of backspace characters. 
Example: 

i) STA TABLE+t3 CTRL L 

*DP3J1 STA TABLE+3 
1.4 CRIO 


Purpose: To input a record from the ecard reader. 
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TABLE 1-2 FST-LINTERNAL CODES. 


029 “T 029 
TASCH | ASCH ITASCH | ASCH Code 
| Char. Code | Char. | Code Graphic 


Code 
Graphic 


@OnNMOoOOWLY@® 
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I> 


QO2zZ=zrmraeH = 
oI 
aa 


LO © NO) O71 © GW MF © ee 
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~ 
Ww 
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|}Carriage Return Delete 
Line Feed 


Bel] 
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Calling Sequence: 


CALL CRIO 

DATA operation 

DATA deb 

DATA error 

— NORMAL RETURN 


operation - 1 BINARY READ 
2 BCD READ 


Description: 


CRIO will read a card into the specified buffer. The two types of read, BINARY 
and BCD, produce twelve and six bits per card column, respectively; the format of 
the resulting buffer contents is discussed in Appendix B. The maximum word count 
one can use without producing a DCB error is 20 for BCD mode and 40 for BINARY. 


The six bit code produced by the BCD read is not the TASCII code expected by the 
system, but it ean be converted to TASCII by the procedure CRASC. Table 1-2 
shows the six-bit eneoding for the ecard eode produced by the 029 keypunch. This 
table shows that there are six ecard codes whose graphic characters do not 
eorrespond to any in the TASCII set; the handling of these is discussed in CRASC. 


CRIO requires manual intervention on ecard jams and validity errors and will retry 
the read when the required intervention has occurred. The validity check occurs 
when an illegal card code is read; this can happen only in the BCD mode. The BCD 
character set can be used to produce all 64 possible combinations in the bed mode. 


The user error routine is entered either as a result of DCB errors, data overflow, or 
an EOF condition. The EOF condition occurs when the ecard reader goes not ready 
and the output stacker is full or the input stacker is empty. In either case, the 
reading of the last card cannot be successful until the card ready goes READY 
again. The normal mode of operation is to ignore this condition and let the pro- 
gram detect a '//' record for an end-of-dile. This record should be followed by a 
dummy one if it is the last record in the input stacker. 


1.5 LPIO 
Purpose: To output a record to the line printer. 
Calling Sequence: 
a) CALL  LPIO 
DATA operation 


DATA deb/space count 
—- NORMAL RETURN 


Ly 


operation - 3 PRINT (no line-feed) 
4 | PRINT (with line-feed) 
6 SPACE N LINES 


b) CALL LPIO 
DATA operation 
eae NORMAL RETURN 


operation - 7 TOP OF FORM 


Description: 


LPIO will transmit the contents of the specified buffer to the line printer or posi- 
tion of the printer paper in a particular way. The buffer is assumed to contain four 
six-bit TASCII characters per word, see Appendix B. 
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The line printer operates in two modes, format mode and normal mode. In the 
format mode, all print and space commands do not consider the space between 
bottom of form (BOF) and top of form (TOF) as part of the page. That is, the page 
perforation is skipped automatically. In the normal mode, the region between BOF 
and TOF can be used for printed output (i.e., where an end of page discontinuity is 
not desired). 


The print commands require a DCB address at CALL+2. The DCB word count 
should not exceed 33, reflecting the maximum (132 character) line printer print 
span. If this should oeceur, characters in excess of 132 will not be printed. In the 
ease of the 80 column printer, if the DCB word count exceeds 20, then 60 
characters will be printed in columns 1-60 of the first of a two line pair and the 
remainder right justified on the second line. For space commands, CALL+2 con- 
tains the number of lines to space; only the low-order seven bits are used. 


1.6 DISCIO 
Purpose: To transmit data between the dise and core memory. 
Calling Sequence: 


CALL DISCIO 

DATA operation 

DATA deb 

DATA error 

— NORMAL RETURN 


operation - 1 BINARY READ 
2 PARITY CHECK 
3 BINARY WRITE 


Description: 


DISCIO will transmit blocks of data between dise and core memory. The maximum 
size of a block is 16,384 words. Every write operation performed by DISCIO is 
automatically followed by a parity check to assure that parity was generated 
properly. 


The third word of the DCB required by DISCO is the dise address of the disc area to 
be read or written. For this purpose, the dise is treated as a magnetic tape with 
16,000 - 48 word records (sectors). The dise address is a binary value in the range 
of '0' to '15999' of the first such record (sector) involved in the transfer. | 
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1.7 MTIO 
Purpose: 


Calling Sequence: 


CALL MTIO 

DATA operation 
DATA deb or count 
DATA error return 
operation 


0 
1 
2 
3 
4 
o 
6 
7 
8 
7 


MTIO transmits blocks of data between magnetic tape and core memory, perform 
error analysis, and executes miscellaneous commands to cause tape movements and 
writing or tape marks. The minimum block size is six (6) words and the maximum is 


16,384 words. 


If the operation specified is either a record skip or file skip, XALL+2 should specify 


To transmit data between core memory and magnetic tape. 


NORMAL RETURN 


BUSY TEST 

READ 

INVALID OP CODE 

WRITE _ 

WRITE TAPE MARK 
RECORD SKIP FORWARD 
RECORD SKIP BACKWARD 
REWIND 

FILE SKIP FORWARD 

FILE BACKWARD 


the number of records or files to be skipped. 


The DCB used by MTIO is a standard 2-word DCB containing word count and core 


buffer address in that order. 


1.8 COMMUNICATION LINK I/O (CLIO) 


This section deseribes the procedures available to users by means of the call 
directive to communicate with the host using the Communications Link Driver, 


CLIO. 
GENERAL DESCRIPTION 


GENERAL FORM 


CALL CLIO 

DATA operation code 
DATA deb address 
BRU error/Busy/EOF 


Calling Sequence: 


CLIO is the host Data Link I/O procedure name and when used in the operand of a 
CALL statement will cause the Data Link Driver to be loaded and linked at 
COREIMAGE CREATE time. 


CALL + 1 - Contains the operation code which defines the desired operation. 


CALL + 2 - Contains the Data Control Block (DCB) address. The DCB is a three 
word block that provides the following information; 


DCB + - Message length (max) 
DCB+1 - Message first word address (FWA) 
DCB + 2 - CLIO status on return 


Data may either be binary or TRASCII. The data message is expressed in FST-2 
words. Recall that there ean be four TRASCII characters, left justified, per FST-2 
word. The maximum word count/character count is 28 words or 112 characters 
respectively for TRASCII or 37 words Binary. 


CALL + 3 - is the error exit on all operations and the busy exit on the busy test. 
This location should contain a branch to a user written error routine for proper 
recovery. The A-register contains a value indicating the error type. 


On all returns from CLIO, the contents of the index registers preserved. The E- 
register as well as DCB + 2 contains the status of CLIO. The A-Register contains 
an error number on error return and zero on a good return (except message type 5, 
the status response). 


CALLING PROCEDURES 
Command 9, Driver Status and Message Control 
Message Type 0, Driver Status 


CALL CLIO 

DATA B4 + B3 

DATA deb 

BRU busy/error 
return - not busy 


Busy is defined as the last initiated write, operation has not completed. This is due 
to the time it takes to perform the operation and also includes the time it takes for 
the host to acknowledge the operation. Busy may also be due to failure, either an 
inoperative interface or a line disconnect (hang-up) condition. If the latter case 
exists and the driver is called with a message type other then 3 No, a find-out error 
will occur after approximately 15 seconds. 


NOTE 


Refer to Figure 1-1 for a diagram of the Opcode format. 
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Opeode = 0, Busy test, if Busy, Rtn = CALL + 3 ELSE CALL + 4 
B3 = 1 Status in E-REG & DCB + 2, RTN = CALL + 4 
B21 = 0, Current input character count 
= 1 


we 


Current output character count 
Message Type 1, File Request 


CALL CLIO 

DATA 10000B + B21 +SSA 
DATA. deb 

BRU error 


This call causes the host to make available (open) the file defined by the header 
found in memory pointed to by the DCB. When a file request is made of the host, 
the next operation must be a file transmit read, message type 2. The Header must 
be TRASCII. 
Opeode: B21 1, Write, a request of the host 

0, Read 

0-2, The Sub-system Source Address 


SSA 
Message Type 2, File Transmit 


CALL CLIO 

DATA 20000B + B21 + B4+ B3+SSA 
DATA deb 

BRU error 


This call causes either the host (write) or the FST-2 (read to create or append to a 
named space for the subsequent upload or download of data records. On an upload 
the file identification is specified by the header found in memory defined by the 
DCB. On a download, the header is an image of the preceding file request message 
type 1. The header must be TRASCII. 


Opeode B21 = 1, Write, used preceding the upload of a data file 
= 0, Read, used preceding the download of a data file 
B3 = 1, Append to an existing file 
= 0, Create a new file 
B4 = 1, The following file is Binary 
= p, The following file is TRASCH 
SSA = f-2, The Sub-System Source address 


Message Type 3, DATA 


CALL CLIO 

DATA 30000B + B21 + B20 + SSA 
DATA deb 

BRU error/End of File 
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This call causes a data message to be read or written. The required sequence of 
file request, status response, and file transmit operations must have first been 
performed. 


Opeode: B21 =1, Write 
= f, Read 
B20 = 1, Binary message 


0, TRASCII message 
SSA = f-2, The Sub-System service address 


Message Type 4, File End 


CALL CLIO 

DATA 40000B + B21 +B3+SSA 
DATA deb 

BRU error 


This eall is executed after the last data message is sent or received and signals the 
completion of the current upload or download. The open file is then either closed 
and made available for other processing or it is purged and deleted depending on bit 
3. 


Opeode: B21 =1, Write 
= J, Read 
B3 =1, Purge and delete the file 


= 0, Close and keep the file 
SSA = (#2, The Sub-System Service address 


Message Type 5, Status Message 


CALL CLIO 

DATA 50000B + B21 
DATA deb 

BRU error 


This call transfers a system status message. A status message can occur after any 
read or write to signal an error, but normally occurs after the file transmit and file 
end messages signalling successful operation. On a read, Status is supplied in the 
A-register (binary) and the first 2 characters of the header (TRASCII)/ See 
Appendix B for the list of Status responses. 


NOTE 
Refer to Figure 1-2 for a diagram of the Status word format. 


Opeode: B21 1, Write, Status value in B3-8 of the opeode 


= 0, Read, A-Register contains the status value 
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Message Type 6, Control Messages 


CALL CLIO 

DATA 60000B + B21 + B4+ B3 
DATA deb 

BRU error 


This call causes control and messages to be communicated between systems. If B5, 
B4 and B3 are zero, a NOP message results. 


There is no difference between types 1, 2, or 3 at the driver level but may take on 
meaning at the next level of software. 


Type 1 - I am about to hang-up. 
Type 2 - Normal DOPSY/TOPSY operator messages. 
Type 3 - Operator messages that are remote system commands. 


Command 1 - Initiate Call-Up 


CALL CLIO 


DATA 1 
DATA deb 
BRU error 


This call initiates the call-up procedure and must be executed prior to performing 
any other call to CLIO (except status requests). 


Opeode: =1 
Command 2 - Initiate Hang-up | 


CALL CLIO 


DATA 2 
DATA deb 
BRU error 


This call initiates hang-up such that line disconnection is performed in an orderly 
Opeode:= 2 


OPCODE FORMAT 


23 21 18 15 12 9: 6 3 0 


|<x— MsG—>|<- ssA-»>|<«—— PARM1——>|-<- cmD->| 
TYPE 

B19 

TRASCII/BINARY 0/1 B20 
READ/WRITE 0/1 B21 

B22 

B23 

Bp-2 CMD, The Command Field 


=f, Status and Message Control 
=1, Initiate Call-Up 
=2, Initiate Hang-Up 
B3-8 PARMI1, A message type specific parameter field 


B9-11 SSA, The Source System Sub-Address 
=f, All non-test station related operations 
=1, Station 1 
=2, Station 2 


B12-15 MSG Type, One of six message types described under command 9. 
along with CLIO status request. 


B19-23 PARM2, A global parameter field. 


Figure 1-1, Opeode Format 
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STATUS 


23 21 18 15 12 9 6 3 0 


EE OO A 


|~— MSG—>|<—SSA-»|<—— CHARACTER CNT ——>| 
YPE | 


7 NEW MESSAGE AVAILABLE = 1 BIB 


CONNECTED/DISCONNECTED 1/0 B19 
TRASCII/BINARY 0/1 B20 
READ/WRITE 0/1 B21 
OPERATOR MSG AVAILABLE = 1 B22 
“BUSY = 1 B23 


NOTES: 


1) When new message available is indicated, 
the new message type is found in B12-15, 
else the message type of the current call. 


2) The character count is input or output 
count dependent on B21 


3) If an error has occurred the E-register will 
differ from DCBt2 in that instead of 
character count, the contents of B0-3 will 
contain a receive error indication if 
applicable. 


BO = 1 = Parity error 
Bl = 1 = Framing error 
B2 = 1 = Overrun error 
B3 = 1 = LRC error 


Figure 1-2 Status Word Format 


1.9 MESSAGE SEQUENCING 


In order to perform a file transfer, upload or download, a prescribed sequence of 
message type calls must be performed. 


Download 

Read/Write Message Type Function 

Write 1 File request 

Read Za* File transmit - open 

Write 5 Status - OK, continue 

Read 3 Data message - first 

Read 4 File end - close 

Write 5 Status - successful transfer 

Upload 

Read/Write Message Type Function 

Write 2 File transmit - open 

Read Hs) Status - OK, continue 

Write a Data message - first 

Write 3 Data message - last 

Write 4 file end - close 

Read 5) Status - successful transfer 

Close - Purge 

Read/Write Message Type Function 

Write 2 file transmit - open 

Read o Status - OK, continue 

Write 4 File end - close with purge 

Read 5 Status - successful operation 
2 If the host cannot honor the file request, this will be a message type 5, status 


with the appropriate status value. 
** If the nost cannot honor this write, a message type 5, Status, will result. 


SECTION 2 
CONVERSION PROCEDURES 


2.1 INTRODUCTION 


This section describes the conversion procedures that are available for translating 
from one character set to another or one number base to another. 


2.2 CRASC 


Purpose: To convert to TASCII the six-bit character code produced by the ecard 
reader. 


Calling Sequence: 


CALL CRASC 
DATA deb 
—-= NORMAL RETURN 


Description: 


The buffer is assumed to be of the format produced by a BCD read in CRIO. Each 
six-bit character is replaced by its TASCII counterpart. Registers affected: A, E. 


2.3 ASCBIN 


Purpose: To convert six-bit TASCII characters to 12 bit column-binary 
characters. 


Calling Sequence: 


CALL — ASCBIN 
DATA deb 
— NORMAL RETURN 


Deseription: 


ASCBIN is used primarily for producing BCD card output. The number of words 
converted is determined from the word count entry in the DCB. Since each -bit 
character is replaced by twelve-bits, the buffer area must be at least twice as 
large as indicated by the DCB. At the completion of the operation, the user's DCB 
word count will be doubled to reflect the increased size. 


REGISTERS AFFECTED: A, E 


Zo 1 


3.4 BINDEC 
Purpose: To convert a binary number to decimal. 
Calling Sequence: 

LDA __obinary 

CALL BINDEC | | 

—— | NORMAL RETURN 


Description: 


BINDEC will return six four-bit characters in the A register. 


These characters 


provide the decimal equivalent of the binary value. Note that if the binary value 


exceeds 999,999 the conversion will be incorrect. 


Registers Affected: A,E 
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SECTION 3 


FILE PROCESSING ROUTINES 


3.1 INTRODUCTION 


The files residing on the dise are called Peripheral Memory Files (PMF). This 
section deals with the procedures that are available for processing these files. 
Some of these procedures are necessarily involved with housekeeping, but most are 
involved with input/output on the files. In the latter group are procedures for doing 
word I/O sequentially. These are discussed in detail in subsequent sections. 


All of the procedures discussed in this section are associated with a PMF header. 
This PMF header contains enough information to permit an arbitrarily large dise 
file to be processed in pieces as small as 48 words, one sector. The PMF header is 
nine words in length; its format is described in Table 3-1. 


In the discussion that follows, all pointers/addresses use '0' origin referencing; the 
first word/character has an address of '0', the second '1', ete. 


The entries FS and FL (see Figure 3-1) are used to define that portion of the disc 
addressable by the file I/O procedures. For output files, this will be the entire 
space allocated to the file. For input files, it is only that portion of the file that 
has been written. FS is a word address relative to the beginning of the dise and FL 
is the number of words that can be referenced. 


At any point in time, a certain portion of the file will be present in main memory. 
This section of the file is called the WINDOW and is defined by WS and WL. WS isa 
word address relative to FS and WL is the number of words currently in main 
memory. WL generally is equal to 48*PL; the only time this is not true is when 
48*PL would force the WINDOW to include part of the next file. 


The area of main memory that the file is segmented into is defined by PS and PL 
(see Figure 3-1). PS is the main memory address of the buffer area and PL is the 
number of sectors available for this buffer. PS and PL must be assigned values by 
the user; PMFH entries in words 2-5 are initialized and maintained by the file 
procedures. 


Table 3-1 illustrates the PMF header entries. The last two words of the PMF 
header contain the name of the file that is being referenced and some flags 
required for housekeeping. Working storage is 'treated' as a dise file and has the 
special name' '(four blanks inside of quotes). The use of the flags in bits 3, 2, 
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and 1 or word 9 is described in more detail in the routines OPEN and CLOSE. The 
flag in bit 0 is set whenever the contents of the WINDOW are altered; this will 
always cause the current WINDOW to be written back to the dic before reading in a 
new one. 


TABLE 3-1 PMF HEADER FORMAT 


Bit Description 


= 
oO | 
“S 

. 


1 23-0 CP - Current Pointer - word/char relative to FS 
2 23-0 WS - Window Start - words relative to FS 
3 23-0 WL - Window Length - words 
4 23-0 FS - File Start - Disc Address in words 
5 23-0 FL - File Length - words 
6 23-0 PS - Page Start - Memory address in gonds 
7 23-0 PL - Page Length - Sectors 
8 23-0 First 4 characters of file name 
9 23-12 Last 2 characters of file name 
9 A ractor DOF Fiie Olen 
9 3 1/0 Flag 
1 = Input 
O = Output 
9 2-1 File Type 
O = STRING 
1 = DATA 
2 = OBJECT 
3 = CORE IMAGE 
9 0 Modify flag. Set if window contents are altered. 


The remaining entry, CP, is a word/character address relative to FS of the next 
word/character to be affected by the sequential I/O procedures. Due to the dual 
interpretation of the CP, it is not advisable to do both word and character I/O ona 
file at the same time. 


The procedures concerned with character I/O, viz: SCAN, GET and PUT, ean be 
used for character processing on string buffers that are completely contained in 
main memory and not associated with a dise file. In order to do this, it is necessary 
for the user to initalize the entries of a dummy PMF so that the WINDOW 
completely encompasses the entire buffer (file). In particular, WS=), FL and WL 
are set to the length of the buffer and FS and PS reference the first location in the 
buffer. CP should be set to the first character position to be affected; the 
remaining entries should be set to zero. 


3-2 


FS Ws 767 ,599 


A. PERIPHERAL MEMORY 


Be 16,383 


B. MAIN MEMORY lH oo aes 


Figure 3-1 Peripheral and Main Memory Header 
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To see how this works, assume that there is a 20 word buffer into which a ecard has 
been read. To retrieve characters from this buffer one at a time in sequence from 
column one to eighty, procedure GET could be used. The following assembly 
language statements would define the PMF header and buffer. 


PMFHEADR DATA 0,0,20,Buffer,20,Buffer,0,0,0 
BUFFER BSS 20 


Whenever a new ecard is read, the CP would need to be reset to zero. Setting the 
entries in this fashion forces the character processing routines to produce an EOF 
return whenever they address beyond the WINDOW, 1.e., BUFFER. This prevents 
them from doing any dise operations. If WL FL, a dise operation will be caused if 
the associated WINDOW is ever aitered. 


In the descriptions that follow, the word "pmfheader" is assumed to be the label on 
the CP, i.e., index register 7 contains the address of the PMF header. 


3.2 OPEN 


Purpose: To initialize a PMF header for processing a disc file. 
Calling Sequence: 


LDX 7,pmfheader 
LDA —__ openflag 
CALL OPEN 

-—- ERROR RETURN 


—— NORMAL 
openflag 0 OUTPUT 
1 INPUT 


Description: 


The only function performed by OPEN is filling in the values of CP, FS, FL, WS, WL 
and the flags so that the associated file may be referenced properly. FL will be set 
to reference the entire space allocated to the file if 'openflag' is an '0', otherwise, 
it is set to address only that portion of the file previously written. CP and WS are 
set to '0', WL to a '-1', and the flags, except for the I/O bit, are set to '0'. The I/O 
bit takes on the value of 'openflag" so that CLOSE can determine what action must 
be taken when the user is through processing the file. 


The entries PS and PL must be initialized by the user. See the introduction, 
paragraph 3-1 for a description of these entries. 


The normal return is taken if the file was opened successfully. The value returned 
in the A register is the value of the CP the last time the file was closed as an 
output file, i.e., the next available slot in the file. This value can be used to 
append new information to an old file by opening the file as an output file and 
storing the A register into the CP entry. Subsequent sequential output operations 
will continue from the end of the old file. 


3-4 


The error return is taken if the file cannot be located in the file directory. 
REGISTERS AFFECTED: Index Register 6, A, E 

3.3 CLOSE 

Purpose: To terminate processing of a disc file. 

Calling Sequence: 


LDX 7,pmfheader 

CALL CLOSE | 

-—— ERROR RETURN 
-—— NORMAL RETURN 


Description: 


CLOSE should be called when a file is opened for output and may be called when 
the file is opened for input. In either case, the first function performed by CLOSE 
is to write the WINDOW back to disc if it has been altered, since the altering of the 
WINDOW contents is independent of how the file was opened. 


If the file has been opened as an output file, the directory entry for the file will be 
updated to reflect its new size and type. The type is determined from the file type 
field in the PMF header flags and the size of the file is determined from the CP, 
which is interpreted as a character count if the file type is STRING and a word 
count if the type is anything else. The file type is assumed to be STRING when a 
file is opened and is changed to type DATA by the PUTW procedure, so that output 
files of type STRING or DATA take ecare of themselves if the sequential I/O 
- procedures are used. 


The error return is taken if the directory entry for an output file cannot be located. 


REGISTERS AND STATE SWITCHES AFFECTED: A, E | 
Index Register 6 if output file is 
closed. 

State Switch 9 


3.4 READ 
- Purpose: ‘To obtain the contents of a specified PMF location. 
Calling Sequence: 

LDX 7,pmfheader 

LDA pmfaddress 

CALL READ 


= EOF RETURN 
aaacae NORMAL RETURN 
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Description: 


If 0 pmfaddress FL,READ will return in the A register the contents of the PMF 
location specified by 'pmfaddress'. If the address is not in the allowable range, the 
EOF return is taken. 


READ and WRITE are the basic procedures used directly or indirectly by all other 
file processing procedures. READ and WRITE call a common subprocedure 
ADRXLATE that uses DISCO to read in new pages. Altered pages are written back 
to dise by means of the subprocedure SWAPOUT. Both of these subprocedures halt 
in the dise error routine when DISCIO cannot perform the required operation 
successfully. Pressing start allows the operation to be retried another ten times. 


REGISTERS AFFECTED: A | 
E on normal return 


3.9 WRITE 
Purpose: To store a value into a specified PMF location. 


Calling Sequence: 


LDX 7,pmfheader 
LDA pmfaddress 
LDE value 


CALL WRITE 

—_— EOF RETURN © 

— NORMAL RETURN 
Description: 
The 0. pmfaddress FL,WRITE will store the contents of the E register into the 
PMF location specified by 'pmfaddress'. If the address is not in the allowage range 
the EOF return is taken. 
See READ (paragraph 4.4) for comments on disc usage. 


REGISTERS AFFECTED: A,E 


3.6 GETW 
Purpose: To obtain the contents of the current word from a PMF. 
Calling Sequence: 

LDX 7,pmfheader 

CALL GETW 


= EOF RETURN 
eee NORMAL RETURN 
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Description: 


If 0_ CP FL,GETW will use CP as the PMF address and perform the same function 
as READ. In addition it will increment CP by one so the next call for GETW will 
obtain the next word. If CP is out of the allowage range, the EOF return is taken. 


REGISTERS AFFECTED: A 
. E on normal return 


3.7 PUTW 
Purpose: To replace the contents of the current word in a PMF. 
Calling Sequence: 


LDX 7,pmfheader 
LDA value 
CALL PUTW 
--- EOF RETURN 

— NORMAL RETURN 


Description: 


If 0 CP FL,PUTW will use CP as the PMF address and perform the same function 
as WRITE. In addition, CP Is advanced by one so that the next eall for PUTW will 
Store into the next word. If CP is out of the allowable range, the EOF return is 
taken. 


REGISTERS AFFECTED: A,E 
3.8 GET 
Purpose: To obtain the current character from a PMF. 
Calling Sequence: 
LDX 7,pmfheader 
CALL GET 
=o5 LETTER RETURN 


ee DIGIT RETURN 
as | OTHER 


Description: 


GET interprets CP as a character address. If 0 _CP/4 FL,GET will return in the 
low order portion of the A register the character addressed by CP. CP will also be 
advanced by one to make the following character the current one. 


T he letter return is taken if the character is one of the characters $, A, B, C,..., 
Z. The digit return is taken for any of the characters 0, 1, 2, 3, 4, 5, 6, 7, 8, 9. 
Control returns to CALLt3 for anything else with an EOF indicated by the value 
177B. 
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REGISTERS AFFECTED: A, E 

3.9 PUT 

Purpose: To replace the contents of the current character in a PMF. 
Calling Sequence: 


LDX 7,pmfheader 

LDA character 

CALL PUT 

-—- EOF RETURN 

~——— NORMAL RETURN 


Description: 


PUT interprets CP as a character address. If 0 CP/4 FL,PUT will store the 
character in the A register into the character position addressed by CP. CP is then 
advanced by one to make the next character the current one. If CP is out of the 
allowable range, the EOF return is taken. 


Registers Affected: A,E 

3.10 SCAN 

Purpose: To obtain the next syntactical entity from a PMF. 

Calling Sequence: 
LDX 7,pmfheader 
CALL SCAN 
— IDENTIFIER RETURN 

-_— NUMBER RETURN 

— STRING RETURN 

_—— CHARACTER RETURN 


Description: 


SCAN uses GET to obtain characters from the PMF to form identifiers, strings and 
numbers. 


_An identifier is a sequence of letters (including$) or digits, the first of which must 
be a letter. Only the first six characters of such sequences are retained and they 
are returned left justified in the A and E registers to CALL?*1. 


Examples: 
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A number is a sequence of digits; if the terminating character is a 'B' the base is 
assumed to be octal, otherwise, decimal is assumed. The low order 24 bits are 
returned to the E register to CALLt2. The terminating character (e.g., blank or 
comma) will be returned in the A register. 


eyainnies: 
10 
77B Equivalent to 63 
16000 


A string is a sequence of characters enclosed in single quotes. Like identifiers, 
only the first six characters are retained. These are returned left justified in the A 
and E resiters to CALL+3. 


Examples: 
'A-B tt 
"A! 
! A! 


The address of the location containing the terminating character for these entities 
is returned in index register 7. 


Single character operators/terminators are returned in the low order portion of the 
A register. In thise case index register 7 still points to the PMF header. 


REGISTERS AFFECTED: A, E and index register 7 for returns 1, 2, 35 
A and E for return 4. 


3.11 GFREC 
Purpose: To obtain the current record from a PMF. 


Calling Sequence: 


LDA fileid 

CALL GFREC 

DATA deb 

--- EOF RETURN 

-_— NORMAL RETURN 

fileid BITS 23-21 FILE TYPE 
0 STRING 
1 DATA 
2 OBJECT 
3 COREIMAGE 

13-0 PMF header address 
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Description: 


GFREC (using GETW) will move the current record from the PMF to the buffer 
defined by the DCB whose address is a CALL=1. The EOF return is taken whenever 
an WOF JIS returned by GETW: the contents of the record obtained are not 
predictable in this case. 


For STRING files this move will terminate only when a 77B character is read or 
GET indicates an EOF. In the former case, the buffer will be padded out with 
blanks and the normal return is taken. If the buffer is smaller than the record, the 
trailing part of the record is lost. | | 

The amount of information transmitted form COREIMAGE or DATA files is deter- 
mined by the DCB word count. It is the responsibility of the calling program to set 
this correctly. 

The amount of information transmitted from an OBJECT file is a function of the 


first word of the record. The buffer would be as large as the largest possible 
record (10 words). 


REGISTER AFFECTED: A, E, Index Register 7 
3.12 PFREC 
Purpose: To move a record into a PMF. 


Calling Sequence: 


LDA fileid 
CALL PFREC 


DATA deb 
as EOF RETURN 
= NORMAL RETURN 


See 3.11 for a description of fileid. 

Description: 

The DCB whose address is at CALL+1 deseribes the buffer that contains the record 
to be moved. Except for OBJECT files, the entire buffer area is moved using 
PUTW or PUT. For OBJECT files the number of words moved is determined from 
the first word of the record, or the iength of the buffer area, whichever is smaller. 
If the file is type STRING, the 77B character is also placed in the file after the 
record. 

The EOF return is taken whenever such a return is given by PUTW or PUT. 


REGISTERS AFFECTED: _ A, E, Index Register 7 
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3.13 FIND 
Purpose: To locate a file on the disc. 


Calling Sequence: 


LDA 'SY MB' 
LDE 'OL' 
BSM FIND 


—-- NOT FOUND RETURN 
es NORMAL RETURN 


Description: 

FIND searches the file directory for the specified dise file. The search begins at 
the beginning of the directory and continues until a match is found or the end-of- 
directory is reached. If a match is found, the main memory address of the found 
entry is placed in index register 7, the binary dise address of the corresponding file 
is placed in the A register and control returns to CALL+2. If no match is found, 
control returns to CALL+1 and the index and A register reference the last 
directory entry and working storage, respectively. 


The index register address is that of the first word of the entry. The other five 
words are at the next five higher memory addresses. 


If bit '0' of the E register is 'l', the system job number is assumed. Otherwise, the 
current job number is used. 


NOTE 
The label FIND must be 'EQU'ed to 356B. 


REGISTERS AND STATE SWITCHES AFFECTED: A, E, Index Registers 6 and 7 
State Switch 7. oa 


3.14 OUTREC 
Purpose: To place a record in an output file. 


Calling Sequence: 


a) LDA FILEIDENT 
CALL OUTRE 
DATA 1 | 


DATA DCB 
— EOF FILE RETRUN 
= NORMAL RETURN 


b) LDA FILEIDENT 
CALL OUTREC 
DATA 0 
— BUSY RETURN 7 
=== NOT BUSY RETURN 


FILEIDENT (for non-disc files): 


BITS 22-21 FILE TYPE 
13-0 FILE NUMBER 

FILE NUMBER 0 POD 

1 TTP 

2 CP (when available) 

3 LP | 

4 

5) 

6 


INREC 


On PWNH OS 
ry 
re 
= 


FILEIDENT (for disc files): 


BITS 22-21 FILE TYPE (as above) 
13-0 PMFH 7 

FILE TYPE STRING 

DATA 

OBJECT 

COREIMAGE 


WN © 


Description: 


OUTREC utilizes the IOCS procedures MTIO, CPIO, LPIO, and TTPIO along with 
PFREC to place the record in the file. OUTREC work much like the IOCS 
procedures in that it automatically overlaps record output with program execution. 
This can be synehronized by doing a 'test.'!. The buffer should not be altered 
however, and is complete when control returns to the calling sequence. A 'test' 
may be performed on an output to a dise file and the NOT BUSY return will always 
be taken. 


The buffer for object and string records should be large enough to accommodate 
the largest record. The number of words actually sent to the file is obtained from 
the record itself for object records and for string records is obtained from the DCB 
and decremented to suppress trailing blanks. 
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If the record is sent to the card punch (when available), it is first edited to provide 
BCD output. The buffer must be large enough to accommodate the edited record; 
it must be twice as large as the DCB word count specifies. 

3.15 INREC 


Purpose: To obtain a record from an input file. 


Calling Sequence: 


LDA FILEIDENT 
CALL INREC 


NOP DCB 
--- EOF/MONITOR REC RETURN 
--- NORMAL RETURN 


FILEIDENT: SEE OUTREC FOR FILEIDENT SPECIFICATION 
Description: 


This procedure will obtain the next record from the specified file (device) and place 
it in the buffer described by the DCB. The input record is always available in this 
buffer when control returns to the calling sequence, i.e., INREC waits until the 
record has been obtained before returning. INREC obtains the record by calling the 
IOCS' procedures MTIO, CRIO, TTRIO and GFREC, DIF. This means that the 
limited editing available in TTRIO is available for records obtained from the 
teletype. 


NOTE 


Records beginning with '$$' in columns 
1 and 2 coming from DIF are treated 


as '//' 


When using GFREC to obtain records from a PMF, the PMF header describes the 
buffer actually used for dise transfers while the DCB describes the buffer which 
- will finally contain the record. 


For files containing variable length records, i.e., string and object files, the buffer 
must be large enough to accommodate the largest record. The EOF return is taken 
if the buffer is too small for a particular record. In retrieving records from string 
files, INREC pads the record with blanks if it is smaller than the buffer. This is not 
done with object the first word of the record enables its exact size to be 
determined. 


3.16 SRCH (ENTREN, WRITDS) 


Purpose: To locate files on the disc. 


Calling Sequence: 


LDA 'SY MB' 

LDE 'OL' 

CALL SRCH 

<< NOT FOUND RETURN 
== FOUND RETURN 


Description: 


SRCH performs the same function as FIND. The main differences are SRCH uses 
DISCIO and is relocatable, while FIND uses its own simple I/O and is not 
relocatable. Another difference is that SRCH has two subprocedures which can be 
used to maintain the file directory. These are WRITDS and ENTRFN. WRITDS will 
write the sector of the directory that is currently in main memory back to the 
directory. ENTRFN must be used after a SRCH failure to enter the name of the 
'new' file into the directory. In the new entry, the ‘last entry' bit is set and all 
other words are set to zero. It is the responsibility of the calling program to fill 
these entries in correctly. Index register 7 points to the new entry. A call for 
ENTREN should be followed by one for WRITDS when entries have been completed. 


The calls for these subprocedures are: 


CALL WRITDS 
CALL ENTRFN 


The latter enters the routine from the previous CALL SRCH and uses parameters 
set up by SRCH. 


3.17 DFILEN 


Purpose: To determine the file number of the file whose name is in the A 
register. 


Calling Sequence: 


LDA file name 

CALL DFILEN 

~~~ INPUT FILE 

--- OUTPUT FILE 

--- NOT A FILE 
Description: 


The Table 3-2, below shows the name/number correspondence of the various files. 


TABLE 3-2 OUTFILES, INFILES, NAME/NUMBER CORRESPONDENCE 


| File (Device) Name | File Number 


TT Printer 
Card Punch 

(if available) 
Line Printer 
Magnetic 

Tape Output 
Disc Qutput 
File 

Data Link 
Output 


Out Files 


TT Keyboard 
Card Reader 
TT Paper 
Tape Reader 
. | Magnetic 

In Files Taper inet 
Disc Input 
File 
Data Link 
Input 


The file name must be left justified in the A register. The error return is taken if 
the file cannot be found in the table. 


If PID or POD is input, the number of the appropriate file will be obtained from 
MICTRL. | 


If the file is found, the appropriate normal return is taken and the file number is 
placed in the A register; otherwise, the error return (CALL+3 ) is taken. 


REGISTERS AFFECTED: Index Registers 7 and 6, A 
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APPENDIX A 


CHARACTER SET 


The internal character set used by the FST-1 and FST-2 software packages is six- 
bit trimmed ASCII, TASCII. TASCII characters are obtained from their seven-bit 
counterparts, parity level excluded, by subtracting 40B. The resulting character 
set is shown in TABLE A-1. 


TABLE A-1  TASCCI CODE 


BIT POSITIONS 5* & 4 


BIT 
POSITIONS 
3 - 0 


WO On DD OO FP WW HOF OO 


ye a a a 


@ 
A 
B 
C 
D 
E 
t 
G 
H 
7 
J 
K 
L 
M 
N 
0 


*Bit 5 is the high-order bit position 


Not all I/O devices supported on the FST-1 and FST-2 accept/produce this code. 
There are, however, conversion procedures for making the proper transformations 
from one character set to another. A description of these procedures can be found 
in paragraph 2.0. 
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APPENDIX B 


BUFFER FORMAT 


The character buffers used by the FST-1 software packages are of two kinds. The 
more common of the two has four six-bit characters per word. The first word of 
the buffer contains the first four characters of the corresponding I/O record; the 
first character is in the high order position of the word. The second buffer word 
contains the next four and so on. This is illustrated in Figure B-1, which assumes 
the buffer starts at location 500. 


~ SAMPLE DATA 


63; 41; 55 163) 41 55) 60 154) 45 00 44 | 45, 00, 44 4164/41) 16 | 64,41, 16 ee] TT 
CHARACTER 


ADDRESS: 2 3/4 5 6 7/ 8 9 10 11/ . 


LOCATION: 500 501 502 


Figure B-1 Four, Six-Bit Characters Per Word Format 


The second part of the illustration shows the relative position of each character in 
the buffer. The high-order bit of each character position in a word is occupied by 
the high order bit of the character residing there. This can be seen by location 
which gives the octal value of each buffer location after the ecard code has been 
converted to trimmed ASCII. 


The other format is used by the ecard I/O devices and has two twelve bit characters 
per word. These twelve bit characters are a result of a column binary operation. 
That is, there is a one-to-one correspondence between the punches in a card column 
and the one in the corresponding twelve bit character. The high and low order bits 
correspond to rows twelve and nine, respectively. 


This kind of a buffer is used by the card reader in the BINARY mode. Diagram in 
Figure B-2 illustrates the format of this buffer. 


SAMPLE DATA 


a 


12 00 41,00] 20, 40, 20 04] 20, 20,40, 20] 00, 00, 40, 40| 41,00, 11,00] 41,00, 41 of 


LOCATION: 
500 501 502 503 504 505 


Figure B-2 Two, Twelve-Bit Characters Per Word Format 


ERROR # 


10 


11 


12 


APPENDIX C 


DRIVER ERROR MESSAGE 


DESCRIPTION 


DATA LINK interrupt and no RS-232 status indicator is set. An 
interrupt has been executed, but 


BG - DATA set change or 
BL - Receiver done or 
BBC - Transmit done are not true. 


Data Set Change (DSC) interrupt has occurred and either no RS- 
232 bit or more than one RS-232 bit has changed since the last 
data set change. 


Lost Data Set Ready (DSR) and not a formal hang-up. The host 


has probably timed out and hung-up due to an uncompleted 
sequence while there was a request in the driver. 


Lost Clear-To-Send (CTS) and transmission was incomplete. 


Lost Receiver Line Signal Detect (RLSD) during a receive pro- 
cedure. 


The Host has hung-up. 


The last message was cancelled. This is due to an illegal sequence 
of line protocal characters. 


Transmit error, 10 successive, attempts at writing a message have 
frailed. Disconnection occurs. 


A message read or write call has been made and the line is not 
connected. A call-up is requested to establish line connection. 


DCB error, a calling parameter ts in error 


a) Command in the opcode is not 9, 1 or 2 

b) Message type in the opcode is greater than 6 

ec) | PARMTI is in error in a Driver Status call 

d) A call for an operator message has been made and none 
exists 

e) PARML is in error on a message type 6 write. 


fon 
(Hi 


DRIVER ERROR MESSAGE (Continued) | 


DCB error, error in the Buffer or message length supplied. 


a) Read an operator message and the buffer provided is insuf- 
ficient (the partial message is past) 

—b) The message supplied the driver is larger than silewee 

ec) Read a message and the buffer provided is insufficient. 


Time out error, the following situtations occur for greater than 15 
seconds | 


a) The driver is hung in a busy state 
b) The host retains line ownership and a write attempts exists 
ro) A call for a read is made and does not complete. 


Message sequence error (normai error at times) 


found | 
e.g., Write Message type 1 
Read Message type 2 but a message type 5 ex- 
ists with host status. 
or Read Message type 3 but a message type 4 ex- 


ists indicating end of file. 


APPENDIX D 


HOST STATUS MESSAGES 
ERROR # DESCRIPTION 
0 The requested operation was performed without error 


-UPLOAD ERRORS- 


1 N/A 
20 N/A 
3 N/A 
4 A file open was attempted and there is a file already open. A file 


transmit message was sent and the subchannel is already in use. 


5 Host RTE error 
Directory search/add error in pple to a file transmit message 
(e.g., Dise full). 


6 Duplicate file, an attempt to create a file which already exists. 


7 Host RTE error 
An open error in response to a file transmit - oppend operation. 


8 _ FST-2 System error 
Attempt to add, with a data message, to a closed file. 


9 Host RTE error 
A dise write error while oppending file data to an open file. 


10 FST-2 System error 
Attempt to close an already closed file. 


11 Host RTE error 
Error encountered while attempting to close a file. 


12 Host RTE error 
Error encountered while attempting to purge a file. 


13 


14 


50 


51 


o2 


HOST STATUS MESSAGES (Continued) 


Host RTE error | 7 
Unable to find the directory entry on a close-purge operation. 


Host RTE error 
A Directory write error during a close-purge operation. 


N/A 


N/A 


N/A 


N/A 


FST-Z System error 
Attempting to close-purge a file and the file ID's are not the 
same. 


-DOWN LOAD ERRORS- 


N/A 


A down load request was: made and a download is already in 
progress. | 


Any file error encountered during a download procedure e.g., the 
requested file was not found, RTE file error. 


00000 00000007 


+ + + 


+ + FF FF HF HH HF FH HH HH OH HH HF HF OH HK OF 


* 
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HOST - FST2 COMM LINK I/O EXAMPLES 


CLIO CALLING SEQUENCE: 


ENT: 
PAL: 


CALL 


DCB: 


N/A 
A-REG 
E-REG 


ERROR # ON ERROR, ELSE 0 
CLIO STATUS 


X-REG'S ARE PRESERVED 


> CALL 
DATA 
DATA 
BRU 


DATA 
DATA 
DATA 


00000 00000000 HOSTIO PROG O 


00001 01000002 


BPU 


BEGIN 


CLIO 

OPCODE 

DCB 

ERROR/BUSY/EOF - ROUTINE 
RTN - NORMAL 


LENGTH (WORDS) 


BUFFER/MESSAGE FIRST WORD ADDR 


0 (STATUS) 


+ + + + 


00000002 
00000002 
00000002 
00000002 
00000002 
00000002 


00002 00000000 
00003 00000004 
00004 00000005 
00005 00000016 
00006 00000017 


00007 20000000 
00010 01000000 


00011 01000000 


00012 00000000 
00013 00023420 


* 


BEGIN 
DONE 
ABORT 
LIST 
ELISE 
rulLstZ 
x 
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(Continued) 


PAGE 


PROGRAM EQUATES FOR ERROR FREE LISTING 


EQU * PROGRAM STARTING POINT 

EQU * PROGRAM ENDING POINT 

EQU: = PROGRAM ERROR EXIT 

EQU’ =* OPERATOR MESSAGE LIST ROUTINE 
DQU * CONVERT & LIST DRIVER ERROR # 
FQU * 


CONVERT & LIST HOST ERROR # & MSG 
CONSTANTS & TEMP STORAGE 


DATA 0 
DATA 4 
DATA 5 
DATA 13 
DATA 178 


DATA 200000008 
DATA 01000000B 


DATA 10050000B MSG TYPE 5, WRITE, OPCODE 


DATA 0 PREVENT 'HUNG' CONDITION 
DATA 10000 INITIAL TIMER VALUE 


00014 
00015 
00016 


00017 
00020 
00021 


00022 
00023 
00024 


00025 
00026 
00027 


00030 
00031 
00032 


00033 
00034 
00035 


00033 
00034 
00035 


00036 
00037 
00040 


00041 
00065 
00113 
00123 
00135 
00211 


00000014 
00000024 
00000041 
00000000 


00000017 
00000023 
00000065 
00000000 


00000022 
00000013 
00000110 
00000000 


00000025 
00000012 
00000123 
00000000 


00000030 
00030052 
00000135 
00000000 


00000033 
00000052 
00000211 
00000000 


00000033 
00000052 
00000211 
00000000 


00000036 
00000001 
00000025 © 
00000000 


00000024 
00000023 
00000013 
00000012 
00000054 
00000054 


+ + FF 


* 


OPIDCB 
OPILEN 


* 


OPODCB 
OPOLEN 


* 


HIDCB 


* 


HODCB 


* 


DLIDCB 
DLILFN 


* 


DLODCB 
DLOLEN 


* 


DLODCB 
DLOLEN 


* 


BSYDCB 


+ + + F 


* 


OPIBFF 
OPOBFF 
HIBFF 
HOBFF 
DLIBFF 
DLOBFF 
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DATA LINK I/O DCB'S 


EQU * 

DATA 20 
DATA OPIBFF 
DATA 0 


OPR MESSAGE INPUT DCB 


EQU * 
DATA 19 
DATA OPOBFF 
DATA 0 


OPR MESSAGE OUTPUT DCB 


EQU * 
DATA 11 
DATA HIBFF 
DATA 0 


EQU * 
DATA 
DATA 
DATA 0 


FQU * 
DATA 42 
DATA DLIBFF 
DATA 0 


EQU * 
DATA 42 
DATA DLOBFF 
DATA 0 


EQU. °* 
DATA 42 
DATA DLOBFF 
DATA 0 


EQU:. “* 
DATA 1 
DATA HODCB 
DATA 0 


BUSY TEST DCB 


DATA LINK I/O BUFFERS 


BSS 20 OPR MSG IN FROM HOST BFFR 
BSS 19 OPR MSG OUT TO HOST BFFR 
BSS ll HEADER INPUT BFFR 

BSS 10 HEADER OUTPUT BFFR 

BSS 44 DATA INPUT BFFR 

BSS 44 DATA OUTPUT BFFR 


40 CHAR HEADER INPUT DCB 


(+ 1 FOR ONTRL INFOQ) 


40 CHAR HEADER QUTPUT DCB 


DATA (MSG TYPE3) INPUT DCB 


DATA (MSG TYPE 3) OUTPUT DCB 


DATA (MSG TYPE 3) OUTPUT DCB 


00265 
00265 


00267 
00274 
00271 


00272 
00273 


00274 
00275 


00276 
00277 


00300 
00301 


00302 
00303 
00304 


00305 


00000265 
12000545 
01000343 


12000511 
01000343 


C+ + + + F 


PLOAD 


025000345 
* 


12000572 
01000347 


12000424 
01000343 


12000572 
01000347 


12000601 | 


01000347 
12000511 
01000343 
02500345 


01000002 


+ OF OF 
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UPLOAD EXAMPLE, BINARY FILE 


EQU 
BSM 
BRU 


* 


WRMT2B 
UPERR1 


RDMT5 
UPPER1 
UPPER2 


WRMT3B 
UPPER3 


DLWALT 
UPERR1 
* 


* 
* 


WRMT3B 
UPERR3 


WRMT4 
UPERR3 


BDMT5 
UPERR1 
UPERR2 


DONE 


WRITE FILE TRANSMIT - OPEN 
ERROR - DRIVER 


READ HOST'S STATUS RESPONSE 
ERROR - DRIVER 
ERROR - HOST 


WRITE FIRST DATA MESSAGE 
ERROR DRIVER/HOST 


WAIT NOT BUSY, SAMPLING 
ERROR - DRIVER 


UPDATE THE DCB & CONTINUE . . 


WRITE THE LAST DATA MESSAGE 
ERROR - DRIVER/HOST 


WRITE FILE END - CLOSE 


WAS TRANSFER SUCCESSFUL? 
NO 
YES, COMPLETE 


FOR OPR MSG 


. OR 


00306 
00307 


00310 
00311 


00312 


00313 
00314 


00315 
00316 


00317 
00320 


00321 


00322 
00323 


00324 
00325 
00326 


00327 


+ + + % 


* 
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00000306 DNLOAD 


12000527 
01000357 


12000455 
01000361 


24000002 
12000617 
01000357 


00000315 
12000473 
01000361 


12000424 
01000367 


01000315 


00000322 
12000502 
01000361 


24000002 
12000617 
01000361 


01000002 


DNLOL 


BRU 


PAGE 


DOWN LOAD EXAMPLE, BINARY FILE 


EQU 
BSM 
BRU 


BSM 
BRU 


LDA 
BSM 
BRU 


EQU 
BSM 
BRU 


BSM 
ONERR1 


(Continued) 


* 


WRMT1 
DNERRI1 


RDMT2 
DNERR2 


DO 
WRMT95 
DNERR1 


* 


RDMT3B 
ONERR2 


DLWAIT 


DNLD1 


RDMT4 . 


DNERR2 
DO 
WRMT5 
DNERR2 


DONE 


WRITE FILE REQUEST 
ERROR - DRIVER 


READ FILE TRANSMIT 
ERROR - DRIVER/HOST 


WRITE - STATUS = OK 


READ N'TH DATA MESSAGE 
ERROR - DRIVER OR NORMAL EOF 


SAMPLE FOR OPERATOR MSG'S 


UPDATE DCB & CONTINUE 


READ FILE END - CLOSE 


WRITE STATUS = OK 


COMPLETE 


00330 


00331 


00332 
00333 
00334 


00335 
00336 


00337 
00340 
00341 


00342 


00000330 
12000536 
01240343 


12000511 
01000343 
02500345 


12000610 
01000343 


12000511 
01000343 
02500345 


+ > OF OF 


CLOSEF 


01000002 © 


PAGE 


EQU 
BSM 
BRU 
BSM 
BRU 
BNEZ 


BSM 


~ BRU 


BSM 
BRU 
BNEZ 


BRU 
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x 
WRMT2 
UPERRI1 


~ RDMT5 


UPERR1 
UPERR2 


WRMT4P 
UPERR1 
RDMT5 

UPERR1 
UPERR2 


DONE 


— CLOSE - PURGE EXAMPLE 


WRITE FILE TRANSMIT - OPEN 


WAS OPERATION SUCCESSFUL? 
NO | 


WRITE FILE END WITH PURGE 


WAS OPERATION SUCCESSFUL? 
NO 
YES, COMPLETE 


00343 
00344 


00345 
00346 


0034/7 
00350 
00351 
00352 
00353 
00354 
00355 
00356 


00357 
00360 


00361 
00362 
00363 
00364 
00365 
02366 
0036/7 
00370 
00371 
00372 


00373 
00374 


00375 
00376 
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00000343 
10000002 
01000002 


00000345 
12000002 
01000002 


00000347 
23000005 
03500343 
07010000 
07022014 
26000006 
23000004 
03200345 
01000343 


00000357 
12000002 
01000002 


00000361 
23000005 
03500357 
07010000 
07022214 
26000006 
23000003 
03200322 
23000004 
03200373 
01000357 


00000373 
2000521 
01000357 


12000002 
01000002 


+ + + + FF H+ F 


UPERRI 


* 


* 


UPERR2 


*k 
* 
* 


UPERR3 


+ + + HF 


DNERR1 


* 
* 
* 


DNERR2 


* 
* 
* 


DNERR3 


(Continued) 


PAGE 


ERROR ROUTINES 


UPLOAD DRIVER ERRORS 


EQU 
BSM 
BRU 


HOST RESPONSES 


EQU 
BSM 
BRU 


* 


ENLIST1L LIST DRIVER ERROR # 


ABORT 


* 


ENLIST2 LIST HOST ERROR # AND MESSAGE 


ABORT 


POSSIBLE NORMAL SEQUENCE 


EQU 
CAM 


* 


Dis 
UPERR1 


12 

O17 

D5 
UPERR2 
UPERR1 


SEQUENCE ERROR ? 
NO, DRIVER ERROR 


YES, GET STATUS IN E-REG 


MESSAGE TYPE 5 ? 
TES, (LEST it 


DOWN LOAD DRIVER ERRORS 


EQU 
BSM 
BRU 


* 


ELISE. 
ABORT 


LIST DRIVER ERROR # 


POSSIBLE NORMAL SEQUENCE 


EQU 
CAM 


* 


D13 
DNERR1 


DNERR3 
DNERP1 


* 


RDMT5S 
DNERR1 


ELISt2 
ABORT 


SEQUENCE ERROR ? 
NO, DRIVER ERROR 


YES, GET STATUS FROM E-REG 
FILE END MESSAGE ? 
YES, NORMAL, GO READ IT 


NO, HOST STATUS ? 
ess Gist 17 


READ HOST RESPONSE 


LIST HOST ERROR # AND MESSAGE 


HOST-FST-2 COMM LINK I/O EXAMPLES 
(Continued) 


PAGE 
* 
* 
* CLIO PROCEDURE CALLS 
* 
x ENT: N/A 
* EXT: N/A 
* CALL: BSM DL(X) | 
* RTN - ERROR, A-REG - # 
* RTN - OK 
* 
* . 
* DLCALL - DATA LINK CALLUP PROCEDURE 
* 
* 
00377 00000000 DLCALL  PZE 0 
00400 12000000 CALL CLIO 
00401 00000001 DATA 1 
00402 00000036 DATA BSYDCB 
00403 01040377 BRU* DLCALL 
00404 36000377 AOM  DLCALL 
00405 01640377 BRU* DLCALL 
* 
x DLHANG - DATA LINK HANG-UP PROCEDURE 
* 
00406 00000000 DLHANG PZE 0 
00407 12000000 CALL CLIO 
00410 00000002 DATA 2 
00411 00000036 DATA BSYDCB 
00412 01040406 BRU* DLHANG 
00413 36000406 AOM  DLHANG 
00414 01040406 BRU* DLHANG 
* 
* DLSTAT - GET DATALINK DRIVER STATUS 
* 
00415 00000000 DLSTAT  PZE 0 
00416 12000000 CALL CLIO 
00417 00000010 DATA 108 
00420 00000035 DATA BSYDCB 
00421 01040415 BRU* DLSTAT 
00422 36000415 AOM DLSTAT 
00423 01040015 BRU* DLSTAT 


HOST-FST-2 COMM LINK I/O EXAMPLES 
(Continued) 


PAGE 
* 
* 
x DLWAIT - WAIT FOR DATA LINKNOT BUSY 
x TEST FOR & LIST ANY OPR MSG'S 
* 
ENT: N/A 
EXT: N/A 
x CALL: BSM DLWAIT 
* RTN - ERROR, A- REG = # 
* TRN - NORMAL 
* 
* 
00424 00000000 DLWAIT  PZE 0 
00425 24000013 LDA 15S SET 15 SECOND TIME-OUT 
00426 14000012 STA TIMER 
* 
00000427 DLWAT!] EQU * 
00427 24000012 LDA TIMER ARE WE HUNG ? 
00430 37000012 SOM TIMER 
00431 02200441 BZ DLWAT2 YES, ERROR 00, ABORT 
* 
00432 12000415 BSM DLSTAT STATUS TEST 
00433 01000441 BRU DLWAT2 ERROR - DRIVER 
* 
00434 07010000 EXC 
00435 23000007 CAM B22 BUSY OR READY, OPR MSG AVAILABLE ? 
00436 03040442 BBC DLWAT3 YES 
00437 02100427 BN DLWAT1 NO, JUST BUSY ? 
00440 36000424 AOM DLWAIT RDY - CONTINUE 
* 
00000441 DLWAT2 QU * 
00441 01000424 BRU* DLWAIT | 
* 
00000442 DLWAT3 EQU * 
00442 12000520 BSM  RDMT6 READ THE OPERATOR MESSAGE 
00443 01000441 BRU DLWAT2 
00444 12000002 BSM LIST & LIST IT 
00445 01000427 BRU DLWAT1 CONTINUE 


HOST-FST-2 COMM LINK I/O EXAMPLES 


(Continued) 
PAGE 
* 
* 
x DATA LINK MESSAGE READ & WRITE ROUTINES 
* 
* ENT: N/A (EXCEPT WRMT5) 
* EXT: N/A 
CALL: BSM RD/WR-MT(X) 
RTN - ERROR 
RTN - OK 
* 
* 
* READ MSG TYPE 1 - FILE REQUEST 
* 
* 
00446 00000000 RDMTI PZE @) 
00447 12000000 CALL CLIO 
00450 00010000 DATA 000100008 
00451 00000022 DATA HIDCB 
00452 01040446 BRU* RDMT1 
00453 36000446 AOM RDMT1 
00454 01040446 BRU* RDMT1 
* 
* READ MSG TYPE 2 - FILE TRANSMIT 


* 


00455 00000000 RDMT2 PZE OQ 


00456 12000000 CALL CLIO 
00457 00020000 DATA 000200008 
00460 00000022 DATA HIDCB 
00461 01040455 BRU* RDMT2 
00462 36000455 AOM — RDMT2 
00463 01040455 BRU* RDMT2 

. : 

* READ MSG TYPE 3, ASCII - DATA 

* 
00464 00000000 RDMT3A = PZE_:=«OO 
00465 12000000 CALL CLIO 
00466 00030000 DATA 000300008 
00467 00000030 DATA DLIDCB 
00470 01040464 BRU* RDMT3A 
00471 36000464 AOM RDMT3A 
00472 01040464 BRU* RDMT3A 

* 

READ MSG TYPE 3, BINARY - DATA 

* 
00473 00000003 RDMT3B =PZE O 
00474 12000000 CALL CLIO 
00475 04030000 DATA 040300008 
00476 00000030 DATA DLIDCB 
00477 01040473 BRU* RDMT3B 
00500 36000473 AOM RDMT3B 
00501 01040473 BRU* RDMT3B 

* 

x READ MSG TYPE 4 - FILE END 

* 
00502 00000000 RDMT4 PZE 0 
00503 12000000 CALL CLIO 
00504 00040000 DATA 000400008 
00505 00000022 DATA HIDCB 
00506 01040502 ~ BRU* -RDMT4 
00507 36000502 AOM RDMT4 
00510 01040502 —BRU* RDMT4 


E-10 


00511 
00512 
00513 
00514 
00515 
00516 
00517 


00520 
00521 
00522 
00523 
00524 
00525 
00526 


00527 
00530 
00531 
00532 
00533 
00534 
00535 


00536 
00537 
00540 
00541 
00542 
00543 
00544 


00545 
00546 
00547 
00550 
00551 
00552 
00553 


00554 
00555 
00556 
00557 
00560 
00561 
00562 


* 
* 
* 


00000000 ROM15 
12000000 
00050000 
00000022 
01040511 
36000511 
01040511 


* 
* 
* 


00000000 RDMT6 
12000000 
00060000 
00000014 
01040520 
36000520 
01040520 
x 


* 
* 


00000000 WRMT1 
12000000 
10010000 
00000025 
01040527 
36000527 
01040527 


* 
* 
* 


00000000 WRMT2 
12000000 
10020000 
00000025 
01040536 
36000536 
01040535 

* 

* 

* 
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READ 


PZE 

CALL 
DATA 
DATA 
BRU* 
AOM 

BRU* 


READ 


PLE 

CALL 
DATA 
DATA 
BRU* 
AOM 

BRU* 


WRITE 


PLE 

CALL 
DATA 
DATA 
BRU* 
AQM 

BRU* 


WRITE 


PZE 

CALL 
DATA 
DATA 
BRU* 
AOM 

BRU* 


WRITE 


Q0000000 WRMT2B PZE 


12000000 
10020020 
00000025 
01040545 
36000545 
01040545 


x 
* 
* 


CALL 
DATA 
DATA 
BRU* 
AQM 

BRU* 


WRITE 


Q0000000 WRMT2P PZE 


12000000 
10020010 
00000025 
01040554 
36000554 
01040554 


CALL 
DATA 
DATA 
BRU* 
AQM 

BRU* 


(Continued) 


MSG TYPE 5 - HOST STATUS 


0 

CLIO 
000500008 
HIDCB 
RDMT5 
RDMT5 
RDMT5 


MSG TYPE 6 - OPERATOR MESSAGE 


0 

CLIO 
00060008 
OPIDCB 
RDMT6 
RDMT6 
RDMT6 


- MSG TYPE 1 - FILE RQUEST 


0 

CEL 
10010008 
HODCB 
WRMT1 
WRMT1 
WRMT1 


MSG TYPE 2 - FILE TRANSMIT 


0 

CLIO 
10020008 
HODCB 
WRMT2 
WRMT2 
WRMT2 


- MSG TYPE 2 - FILE TRANSMIT, BINARY 


0 

CLIO 
100200208 
HODCB 
WRMT2B 
WRMT2B 
WRMT2B 


- MSG TYPE 2 - FILE TRANSMIT + APPEND 


0 

CLIO 
100200108 
HODCB 
WRMT2P 
WRMT2P 
WRMT2P 


00563 
00564 
00565 
00566 
00567 
00570 
00571 


00572 
00573 
00574 
00575 
00576 
00577 
00600 


00601 
00602 
00603 
00604 
00605 
00606 
00607 


00610 
00611 
00612 
00613 
00614 
00615 
00616 


00000000 WRMT3A 


12000000 
10030000 
00000033 
01040563 
36000563 
01040563 


00000000 
12000000 
14000000 
00000033 
01040572 
36000572 
01040572 


00000000 
12000000 
10040000 
00000025 
01040601 
36000601 
01040601 


00000000 
12000000 
10040010 
00000025 
01040610 
36000610 
01040610 


* 


* 


* 


* 
* 


WRMT3B 


WRMT4 


* 
* 
* 


WRMT4P 
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WRITE 


PZE 

CALL 
DATA 
DATA 
BRU* 
AQM 

BRU* 


WRITE 


PZE 
CALL 
DATA 
DATA 
BRU* 
AOM 


BRUX | 


WRITE 


PZE 

CALL 
DATA 
DATA 
BRU* 
AQM 

BRU* 


WRITE 


PLE 
CALL 
DATA 
DATA 
BRU* 
~AQM 
BRU* 


(Continued) 


MSG TYPE 3, ASCII - DATA 


0 

CLIO 
10030000B 
DLODCB 
WRMT34 
WRMT 34 
WRMT3A 


MSG TYPE 3, BINARY - DATA 


0 

CLIO 
14030000B 
DLODCB 
WRMT3B 
WRMT3B 
WRMT3B 


MSG TYPE 4 - FILE END 


0 

CLIO 
10040000B 
HODCB 
WRMT4 
WRMT4 
WRMT4 


MSG TYPE 4 - FILE END W/PURGE 


0 

CLIO 
100400108 
HODCB 
WRMT4P 
WRMT4P 
WRMT4P 


00617 
00520 
00621 
00622 
00623 
00624 
00625 
00625 
00627 
00630 


00631 
00632 
00633 
00634 
00635 
00636 
00637 


00637 


00000000 


07026003 


27000011 
14000624 
12000000 
10050000 
00000025 
01040617 
36000617 
01040617 


00000000 
12000000 
10060020 
00000017 
01040631 
36000631 
01040631 


00000000 


WRMT5 


WRMT6 


+ + 


HOST-FST-2 COMM LINK I/O EXAMPLES 
(Continued) 


PAGE 


WRITE MSG TYPE 5 - STATUS MSG ~ 


as 
a 
OR 
STA 
CALL 
DATA 
DATA 
BRU* 
AOM 
BRU* 


WRITE 


PLE 

CALL 
DATA 
DATA 
BRU* 
AOM 

BRU* 


END 


0 

3 
WMT5 
*+? 
CLIO 


100500008 


HODCB 
WRMT5 
WRMT5 
WRMT5 


MERGE IN STATUS ERROR # 


MSG TYPE 6 - OPERATOR MESSAGE 


0 
CLIO 


10060020B 
OPODCB 


WRMT6 
WRMT6 
WRMT6 


ASCBIN Conversion Routine, 2-1 
BINDEC Conversion Routine, 2-1 


Character Buffer, FST-1, -2, B-1 
Formats (Figures), B-1, B-2 
Character Set, Internal, A-1 
CLIO Communications Link Driver, 1-9 
Calling Sequence, 1-9 
General Form, 1-9 
Message type 0, Driver Status, 1-10 
Message type 1, File Request, 1-10 
Message type 2, File Transfer, 1-11 
Message type 3, Data, 1-11 
Message type 4, File End, 2-11 
Message type 5, Status 1-12 
Message type 6, Control, 1-12 
Opeode Format (Figure), 1-13 
Status Message format (Figure), 1-14 
CLOSE File Processing Routine, 1-14 
CRASC Conversion Routine, 2-1 
CRIO I/O Routine, 1-5 


DFILEN File Processing Routine, 3-14 
DISCIO I/O Routine, 1-8 


Error Messages 
Driver, C-1 
Host Status, D-1 
Examples, FST-2 COMM LINK I/O, E-1 


FIND File Processing Routine, 3-11 
GET File Processing Routine, 3-7 


GETW File Processing Routine, 3-6 
GFREC File Processing Routine, 3-9 


INDEX 


Header, PMF, 3-1 


Description, 3-1 

Format (Table), 3-2 

Peripheral and Main Memory (Figure), 
3-3 


INREC File Processing Routine, 3-13 


LPIO I/O Routine, 2-7 


Message Sequencing, 2-15 


Close function, 2-15 
Download function, 2-15 
Upload function, 2-15 


MTIO I/O Routine, 2-8 


Name/Number Correspondence (Table), 3-15 


OPEN File Processing Routine, 3-4 
OUTREC File Processing Routine, 3-11 


PFREC File Processing Routine, 3-10 
PMF Peripheral Memory Files, 3-1 
PUT File Processing Routine, 3-8 
PUTW File Processing Routine, 3-7 


READ File Processing Routine, 3-5 


SCAN File Processing Routine, 3-8 
SRCH File Processing Routine, 3-14 


Subprocedures: 
ENTREN, 3-14 
WRITDS, 3-14 


TTPIO I/O Routine, 2-4 
TTRIO I/O Routine, 2-4 


WRITE File Processing Routine, 3-6 


Index-1 


